Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Dialog Box Messages

GXJobDefaultFormatDialog

QuickDraw GX sends the GXJobDefaultFormatDialog message when the application displays the Page Setup dialog box. You can override the GXJobDefaultFormatDialog message to modify the behavior or appearance of the dialog box. Your override of the GXJobDefaultFormatDialog message must match the following formal declaration:

OSErr MyJobDefaultFormatDialog (gxDialogResult *aDialogResult);

aDialogResult

On return, a poiner to a value that specifies the selection made by the user in the dialog box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXJobDefaultFormatDialog message when the user clicks the More Choices button in the Page Setup dialog box. The application calls the GXJobDefaultFormatDialog function to display the extended Page Setup dialog box.

The default implementation of this message adds the standard printing panels and interface and then displays the dialog box.

You usually override this message to customize the dialog box by adding panels using the GXSetupDialogPanel function. You can add your own panels to the dialog box through the normal QuickDraw GX printing calls.

SPECIAL CONSIDERATIONS

You never send the GXJobDefaultFormatDialog message yourself.

You must forward the GXJobDefaultFormatDialog message to other message handlers. Add your panels and then forward the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

You can find an example of an override of the GXJobDefaultFormatDialog message in Listing 3-7 on page 3-29 in the chapter "Printer Drivers."

The GXSetupDialogPanel function is described on page 5-28 in the chapter "Printing Functions for Message Overrides."

The GXJobDefaultFormatDialog function is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help